home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1993…ch: Other People's Memory / ADC Developer CD (1993-03) (''Other People's Memory'')_iso / Dev.CD Mar 93.iso / Development Platforms / Apple II / Essentials / Technical.Notes / IIGS / TN.IIGS.012 < prev    next >
Encoding:
Text File  |  1992-07-15  |  14.0 KB  |  380 lines  |  [TEXT/GEOL]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5. Apple IIgs
  6. #12: Tool Set Interdependencies
  7.  
  8. Revised by: Matt Deatherage & Dave Lyons                             May 1992
  9. Written by: Jim Merritt                                            April 1987
  10.  
  11. This Technical Note lists all known interdependencies between system tool sets
  12. on the Apple IIgs.
  13.  
  14. CHANGES SINCE JANUARY 1990:  Added new and changed dependencies for System
  15. Software 6.0.
  16. _____________________________________________________________________________
  17.  
  18. A tool set is dependent upon another if you must start the latter before
  19. starting the former.  You should start tool sets in the order listed below.
  20. Names marked with an asterisk (*) indicate a recommendation to start the
  21. corresponding tool set, but the order is not required for operation of the
  22. dependent tool.  Apple recommends using StartUpTools to start up all the tool
  23. sets your application needs.  See the Apple IIgs Toolbox Reference, Volume 3
  24. for more details.
  25.  
  26.  
  27. TOOL SET INTERDEPENDENCIES
  28.  
  29. Tool Locator                                     Tool #1 ($01)
  30.     No dependencies.  Always start this tool set before any others.
  31.  
  32. Memory Manager                                   Tool #2 ($02)
  33.     Tool Locator        (#1)
  34.  
  35. Miscellaneous Tools                              Tool #3 ($03)
  36.     Tool Locator        (#1)
  37.     Memory Manager      (#2)
  38.  
  39. QuickDraw II                                     Tool #4 ($04)
  40.     Tool Locator        (#1)
  41.     Memory Manager      (#2)
  42.     Miscellaneous Tools (#3)
  43.  
  44. Desk Manager                                     Tool #5 ($05)
  45.     Tool Locator        (#1)
  46.     Memory Manager      (#2)
  47.     Miscellaneous Tools (#3)
  48.     QuickDraw II        (#4)
  49.     Event Manager       (#6)
  50.     Window Manager      (#14)
  51.     Control Manager     (#16)
  52.     Menu Manager        (#15)
  53.     Line Edit           (#20)
  54.     Dialog Manager      (#21)
  55.     Scrap Manager       (#22)
  56.  
  57. Event Manager                                    Tool #6 ($06)
  58.     Tool Locator        (#1)
  59.     Memory Manager      (#2)
  60.     Miscellaneous Tools (#3)
  61.  
  62. Scheduler                                        Tool #7 ($07)
  63.     Tool Locator        (#1)
  64.     Memory Manager      (#2)
  65.     Miscellaneous Tools (#3)
  66.  
  67. Sound Tools Set                                  Tool #8 ($08)
  68.     Tool Locator        (#1)
  69.     Memory Manager      (#2)
  70.     Miscellaneous Tools (#3)
  71.  
  72. Apple Desktop Bus (ADB)                          Tool #9 ($09)
  73.     Tool Locator        (#1)
  74.  
  75. SANE (Standard Apple Numeric Environment)        Tool #10 ($0A)
  76.     Tool Locator        (#1)
  77.     Memory Manager      (#2)
  78.  
  79. Integer Math Tools                               Tool #11 ($0B)
  80.     Tool Locator        (#1)
  81.  
  82. Text Tools                                       Tool #12 ($0C)
  83.     Tool Locator        (#1)
  84.  
  85. Window Manager                                   Tool #14 ($0E)
  86.     Tool Locator        (#1)
  87.     Memory Manager      (#2)
  88.     Miscellaneous Tools (#3)
  89.     QuickDraw II        (#4)
  90.     Event Manager       (#6)
  91.   * QuickDraw Aux       (#18)                    Required in 6.0 and later,
  92.                                                  and the window manager loads
  93.                                                  and starts it for you.
  94.     Control Manager     (#16)
  95.     Menu Manager        (#15)
  96.     * Line Edit         (#20)                    For AlertWindow call only
  97.     * Font Manager      (#27)                    For AlertWindow call only
  98.     * Resource Manager  (#30)                    For using resources in Window
  99. Manager calls.
  100.  
  101.  
  102. Menu Manager                                     Tool #15 ($0F)
  103.     Tool Locator        (#1)
  104.     Memory Manager      (#2)
  105.     Miscellaneous Tools (#3)
  106.     QuickDraw II        (#4)
  107.     Event Manager       (#6)
  108.     Window Manager      (#14)
  109.     Control Manager     (#16)
  110.     * Resource Manager  (#30)                    For using resources in Menu
  111. Manager calls.
  112.  
  113.  
  114. Control Manager                                  Tool #16 ($10)
  115.     Tool Locator        (#1)
  116.     Memory Manager      (#2)
  117.     Miscellaneous Tools (#3)
  118.     QuickDraw II        (#4)
  119.     Event Manager       (#6)
  120.     Window Manager      (#14)
  121.     Menu Manager        (#15)
  122.   * QuickDraw Auxiliary (#18)                  For statText controls.
  123.   * Line Edit           (#20)                  For editLine controls.
  124.   * Font Manager        (#27)                  For statText controls.
  125.   * List Manager        (#28)                  For list controls.
  126.   * Resource Manager    (#30)                  For using resources in Control
  127.                                                Manager calls.
  128.   * Text Edit           (#34)                  For editText controls.
  129.  
  130.    NOTE: You should consider the Window, Control, and Menu
  131.          Managers as one unit and start them in the given order.
  132.  
  133. System Loader                                    Tool #17 ($11)
  134.     Tool Locator        (#1)
  135.     Memory Manager      (#2)
  136.     Miscellaneous Tools (#3)
  137.  
  138. QuickDraw Auxiliary Routines                     Tool #18 ($12)
  139.     Tool Locator        (#1)
  140.     Memory Manager      (#2)
  141.     Miscellaneous Tools (#3)
  142.     QuickDraw II        (#4)
  143.     * Font Manager      (#27)
  144.  
  145.    NOTE : QuickDraw Auxiliary uses the Font Manager in the picture
  146.           drawing routines.  For proper operation, you should
  147.           start the Font Manager before using the QuickDraw
  148.           Auxiliary picture routines; however, the picture
  149.           routines do not fail if the Font Manager is not present.
  150.  
  151. Print Manager                                    Tool #19 ($13)
  152.     Tool Locator        (#1)
  153.     Memory Manager      (#2)
  154.     Miscellaneous Tools (#3)
  155.     QuickDraw II        (#4)
  156.     QuickDraw Auxiliary (#18)
  157.     Event Manager       (#6)
  158.     Window Manager      (#14)
  159.     Control Manager     (#16)
  160.     Menu Manager        (#15)
  161.     Line Edit           (#20)
  162.     Dialog Manager      (#21)
  163.     List Manager        (#28)
  164.     Font Manager        (#27)
  165.  
  166.  
  167. Line Edit                                        Tool #20 ($14)
  168.     Tool Locator        (#1)
  169.     Memory Manager      (#2)
  170.     Miscellaneous Tools (#3)
  171.     QuickDraw II        (#4)
  172.     Event Manager       (#6)
  173.   * QuickDraw Auxiliary (#18)                    For Text2 items; see below.
  174.     Scrap Manager       (#22)
  175.   * Font Manager        (#27)                    For Text2 items; see below.
  176.  
  177. Dialog Manager                                   Tool #21 ($15)
  178.     Tool Locator        (#1)
  179.     Memory Manager      (#2)
  180.     Miscellaneous Tools (#3)
  181.     QuickDraw II        (#4)
  182.     Event Manager       (#6)
  183.     Window Manager      (#14)
  184.     Control Manager     (#16)
  185.     Menu Manager        (#15)
  186.   * QuickDraw Auxiliary (#18)                    For Text2 items; see below.
  187.     Line Edit           (#20)
  188.   * Font Manager        (#27)                    For Text2 items; see below.
  189.  
  190.    NOTE : Line Edit, the Dialog Manager, and the Control Manager
  191.           require the presence of the Font Manager and QuickDraw
  192.           Auxiliary if you use LETextBox2, statText controls, or
  193.           LongStatText2 items which require any font styling
  194.           (e.g., outline, boldface, etc.).
  195.  
  196. Scrap Manager                                    Tool #22 ($16)
  197.     Tool Locator        (#1)
  198.     Memory Manager      (#2)
  199.  
  200. Standard File Operations                         Tool #23 ($17)
  201.     Tool Locator        (#1)
  202.     Memory Manager      (#2)
  203.     Miscellaneous Tools (#3)
  204.     QuickDraw II        (#4)
  205.     Event Manager       (#6)
  206.     Window Manager      (#14)
  207.     Control Manager     (#16)
  208.     Menu Manager        (#15)
  209.   * QuickDraw Auxiliary (#18)                    Required in 6.0 and later,
  210.                                                  and the Window Manager loads
  211.                                                  and starts it for you.
  212.     Line Edit           (#20)
  213.     Dialog Manager      (#21)
  214.   * List Manager        (#28)
  215.   * Resource Manager    (#30)                    For using resources in
  216.                                                  Standard File Operations
  217.                                                  calls.
  218.  
  219.    NOTE : Standard File 3.0 and later use the List Manager for
  220.           displaying a list of file names.  Although Standard File
  221.           functions properly if the application has not started
  222.           the List Manager, it saves time if the application does
  223.           so.
  224.  
  225. Note Synthesizer                                 Tool #25 ($19)
  226.     Tool Locator        (#1)
  227.     Memory Manager      (#2)
  228.     Sound Tools         (#8)
  229.  
  230. Note Sequencer                                   Tool #26 ($1A)
  231.     Tool Locator        (#1)
  232.     Memory Manager      (#2)
  233.     Sound Tools         (#8)
  234.     Note Synthesizer    (#25)
  235.  
  236.    Note : The Note Sequencer automatically handles the start and
  237.           shutdown of the Free-Form Sound Tools (#8) and the Note
  238.           Synthesizer (#25), so programs that use the Note
  239.           Sequencer must not execute start or shutdown calls for
  240.           those tools.  Automatic start does not imply automatic
  241.           loading.  If you plan to use the Note Sequencer, you
  242.           must still load the Free-Form Sound Tool and the
  243.           Synthesizer Tool explicitly through calls to the Tool
  244.           Locator routines LoadTools or LoadOneTool or by calling
  245.           the System Loader and Tool Locator directly in
  246.           appropriate cases.
  247.  
  248. Font Manager                                     Tool #27 ($1B)
  249.     Tool Locator        (#1)
  250.     Memory Manager      (#2)
  251.   * Miscellaneous Tools (#3)                     For ChooseFont call only.
  252.     QuickDraw II        (#4)
  253.   * Integer Math Tools  (#11)                    For ChooseFont call only.
  254.   * Window Manager      (#14)                    For ChooseFont call only.
  255.   * Control Manager     (#16)                    For ChooseFont call only.
  256.   * Menu Manager        (#15)                    For FixFontMenu call only.
  257.   * List Manager        (#28)                    For FixFontMenu
  258.                                                  and ChooseFont calls.
  259.   * Line Edit           (#20)                    For ChooseFont call only.
  260.   * Dialog Manager      (#21)                    For ChooseFont call only.
  261.  
  262. List Manager                                     Tool #28 ($1C)
  263.     Tool Locator        (#1)
  264.     Memory Manager      (#2)
  265.     Miscellaneous Tools (#3)
  266.     QuickDraw II        (#4)
  267.     Event Manager       (#6)
  268.     Window Manager      (#14)
  269.     Control Manager     (#16)
  270.     Menu Manager        (#15)
  271.  
  272. Audio Compression and Expansion (ACE)            Tool #29 ($1D)
  273.     Tool Locator        (#1)
  274.     Memory Manager      (#2)
  275.  
  276. Resource Manager                                 Tool #30 ($1E)
  277.     Tool Locator        (#1)
  278.     Memory Manager      (#2)
  279.  
  280.  
  281. MIDI Tools                                       Tool #32 ($20)
  282.     Tool Locator        (#1)
  283.     Memory Manager      (#2)
  284.     Miscellaneous Tools (#3)
  285.     Sound Manager       (#8)
  286.   * Note Synthesizer  (#25)
  287.  
  288.  
  289.    NOTE : The MIDI Tools require the Note Synthesizer if you
  290.           intend to use the MIDI clock feature.  If you are not
  291.           using the MIDI clock, the Note Synthesizer is not
  292.           required.
  293.  
  294. Text Edit                                        Tool #34 ($22)
  295.     Tool Locator        (#1)
  296.     Memory Manager      (#2)
  297.     Miscellaneous Tools (#3)
  298.     QuickDraw II        (#4)
  299.     Event Manager       (#6)
  300.     Window Manager      (#14)
  301.     Menu Manager        (#15)
  302.     Control Manager     (#16)
  303.     QuickDraw Auxiliary (#18)
  304.     Scrap Manager       (#22)
  305.     Font Manager        (#27)
  306.   * Resource Manager    (#30)                    For using resources in Text
  307.                                                  Edit calls.
  308.  
  309. MIDI Synth                                       Tool #35 ($23)
  310.     Tool Locator        (#1)
  311.     Memory Manager      (#2)
  312.     Miscellaneous Tools (#3)
  313.     Sound Tools         (#8)
  314.  
  315. Media Control Tool                               Tool #38 ($26)
  316.     Tool Locator        (#1)
  317.     Memory Manager      (#2)
  318.     Miscellaneous Tools (#3)
  319.     Integer Math        (#11)
  320.     Resource Manager    (#30)
  321.  
  322. Recommended Start Order
  323.  
  324. A close look at the preceding information will reveal apparent "circular
  325. dependencies" between various tool sets (i.e., two or more tool sets may
  326. depend upon each other).  To resolve the issue of which tool set to start
  327. first in such a situation, here is a list of the most commonly used tool sets,
  328. given in the order in which an application should start them.  You may start
  329. those tools which are indented at a specific level at that time or any time
  330. thereafter.
  331.  
  332.     Tool Locator        (#1)
  333.                         ADB Tools                (#9)
  334.                         Integer Math Tools       (#11)
  335.                         Text Tools               (#12)
  336.     Memory Manager      (#2)
  337.                         SANE                     (#10)
  338.                         ACE                      (#29)
  339.     Resource Manager    (#30)
  340.     Miscellaneous Tools (#3)
  341.                         Scheduler                (#7)
  342.                         System Loader            (#17)     LoaderStartup does
  343.                                                            nothing.
  344.                         Media Control            (#38)
  345.     QuickDraw II        (#4)
  346.                         QuickDraw II Auxiliary   (#18)
  347.     Event Manager       (#6)
  348.     Window Manager      (#14)
  349.     Control Manager     (#16)
  350.     Menu Manager        (#15)
  351.     Line Edit           (#20)
  352.     Dialog Manager      (#21)
  353.     either
  354.             Sound Tools then     (#8)
  355.             Note Synthesizer     (#25)
  356.     or
  357.             Note Sequencer       (#26)
  358.             MIDI Tools           (#32)
  359.             MIDI Synth           (#35)
  360.     Standard File       (#23)
  361.     Scrap Manager       (#22)
  362.     List Manager        (#28)
  363.     Font Manager        (#27)
  364.     Print Manager       (#19)
  365.     Text Edit           (#34)
  366.     Desk Manager        (#5)
  367.  
  368.  
  369.    NOTE : Although you may start the sound-related tools any time
  370.           after the Miscellaneous Tools, we recommend you start
  371.           them after most of the Desktop-related tools.  We also
  372.           recommend you start the Desk Manager last and shut it
  373.           down first.
  374.  
  375.  
  376. Further Reference
  377. _____________________________________________________________________________
  378.  
  379.    o   Apple IIgs Toolbox Reference
  380.